home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Magnum One
/
Magnum One (Mid-American Digital) (Disc Manufacturing).iso
/
d1
/
cudup12.arc
/
CUDUP.DOC
next >
Wrap
Text File
|
1989-09-30
|
18KB
|
386 lines
Colorado Utilities Duplicate File Manager (CUDUP)
version 1.2
by
Fred C. Hill
Micro System Solutions
_______
____|__ | (tm)
--| | |-------------------
| ____|__ | Association of
| | |_| Shareware
|__| o | Professionals
-----| | |---------------------
|___|___| MEMBER
Your first use of CUDUP constitutes agreement to the following license
provisions. If you do not agree to them please do not use this program.
CUDUP is a copyrighted program offered 'as is' for your personal use, testing
and evaluation. A limited license is granted to use and to duplicate this
program for your personal use. After a reasonable period of time (approx 2
weeks) you are expected to register with the author or discontinue your use
of this program.
Micro System Solutions authorizes you to make archive copies of this software
for the sole purpose of back-up and protecting your investment from loss.
The executable version along with this documentation, in an unmodified
format, may be freely shared with anyone. You may not distribute any of the
CUDUP source code or pre-compiled units (TPU files). You may utilize the
source code for anything you desire as long as the distribution of the
resulting program does not bring you into a direct competition with Micro
System Solutions.
The source for CUDUP is provided only to registered users.
This software may be used by one person on as many computer systems as that
person uses.
Micro System Solutions warrants any physical diskettes and documentation
provided to be free of defects in material and workmanship for a period of
30 days from the date of receipt. If you notify us of such a defect within
the warranty period, Micro System Solutions will replace the defective
diskette(s) or documentation at no cost.
Ombudsman Policy:
Fred C. Hill is a member of the Association of Shareware Professionals (ASP).
ASP wants to make sure that the shareware principle works for you. If you are
unable to resolve a shareware-related problem with an ASP member by
contacting the member directly, ASP may be able to help. The ASP Ombudsman
can help you resolve a dispute or problem with an ASP member, but does not
provide technical support for members' products. Please write to the ASP
Ombudsman at P.O. Box 5786, Bellevue, WA 98006 or send a Compuserve message
via easyplex to ASP Ombudsman 70007,3536
Trademarks
Turbo Power Software is a trademark of Turbo Power Software
Turbo Professional is a registered trademark of Sunny Hill Software, used
under license to Turbo Power Software
Turbo Pascal is a trademark of Borland International.
MS-DOS is a trademark of Microsoft Corporation.
IBM PC, XT, AT are registered trademarks of International Business Machines
Corporation.
ARC is a trademark of System Enhancement Associates (SEA)
Software required
CUDUP requires no additional software to execute. It will, however, only
execute properly under MS/DOS version 3.0 and higher. (It has not been tested
under MS/DOS 4.x) You may elect to add one or more compression/decompression
programs from the following list:
file
pgm ext company version comments
--- --- ------- ------- ----------------
ARC ARC SEA 6.0 * not implemented
DWC DWC ???? ???? * not implemented
PAK PAK ???? 1.6 * implemented using ARC
ARC LARC K. Miki * implemented using LHARC
LBR LBR ???? ???? * not implemented
LZH LHARC H.Yoshizaki 1.13
MD MD ???? ???? * not implemented
ARC PKPAK PKWare all
ZIP PKZIP PKWare 1.01
ZOO ZOO ???? ???? * implemented/not tested
Acknowledgements
A special thanks to Phillip K. Burns for the outstanding work he has done in
providing the programming world with the source to read the compression
decompression library directories used in this product. Thanks also to the
many people and companies involved in the programming of those utilities.
The programming tool used in this project is Turbo Professional 5.0 by Turbo
Power Software. This is a library of over 600 state-of-the-art routines
covering almost all areas of IBM PC programming. They have provided us with
the capability to provide better products to our users. Micro System
Solutions uses the TPro tools exclusively in its products and recommends them
highly to novice and experienced programmers alike.
CUDUP manipulates the files on your disk through standard DOS calls. Neither
the author nor Micro System Solutions accept any responsibility for damaged
or lost files, data or media from use of this program.
Hardware required
CUDUP runs on any 100% IBM compatible microcomputer. It will use as much
memory as you have available for the program and the required data storage.
CUDUP will create a configuration file if the Save & Exit option is selected
in the environment menu. No other disk files other than the program (.EXE)
file are required. This documentation assumes you will be running CUDUP from
a hard drive installed as drive C:, however CUDUP will run from any hard or
floppy drive on your system.
Although it has not been tested, CUDUP should run on a network drive as well.
No file locks are done however and contention problems may arise during file
deletions. Each user should have a registered copy of CUDUP or the
organization should have a LAN site license.
Registration
Date:_____________
FROM:
Name:____________________________ Company:_________________________
Address:_________________________ Title:___________________________
City:______________________ State:________ Zip:___________
Telephone:_____________________ Home( ) Office ( )
Where did you first get/hear of our product? ________________________
Colorado Utilities Duplicate File manager (CUDUP) $27.00
includes diskette with:
1. Latest executable version
2. Documentation on disk
3. Complete source
(does not include Turbo Professional libraries)
4. Shipping and Handling
For overseas shipment add: $ 3.00
Colorado customers add 3% state sales
tax and appropriate local tax: $ _______
Order Total: $ _______
Diskette format 5.25"______ or 3.5"_______ (check one)
Send to:
************************** VISA or MASTERCARD ACCEPTED:
* Micro System Solutions *
* * (circle one)
* 5417 S. Cimarron Rd. *
* * Card No.___________________________
* Littleton, CO 80123 *
* * Expiration Date:____/____
**************************
Authorized
Signature:________________________________Executing CUDUP
Start CUDUP from the command line as follows:
CUDUP [/M] [/I] [d:]
all parameters are optional and mutually exclusive.
/M - initializes the program using the monochrome (B&W)
colorset.
/I - begins execution at the environment menu. This option
allows you to set the colors and/or compression protocols
for the immediate execution instead of a furture one.
/E - disables compression library expansion. Only DOS files
will be processes during this session. This flag will
revert to enable expansion at the termination of this
session.
d: - d: is the optional disk drive to read from. The default
drive will be used if d: is not provided. Only one drive
is allowed in this version of CUDUP. Future versions
will support multiple disk drives.
If the /I (initialize) option is used the program begins execution in the
environment menu, which allows you to establish what the current and possibly
subsequent program executions will be like. While in the environment menu you
may elect to change colors, or select the compression protocol used during
the duplicate file check. See the section on Environmental changes for
complete details.
CUDUP reads the entire disk.... storing DOS files.... reading any of the
implemented compression library files.... and storing the internal filenames
into a large memory array. When (and if) the available memory becomes full
CUDUP will continue reading directories but will not add additional files
into the array.
When CUDUP finishes reading all filenames on the disk, the array is sorted
and non-duplicates are discarded. The remaining files (duplicates) are
displayed.
Browsing through the list of files is done using the cursor control keys.
The program will terminate and return to DOS when the Esc key is hit while
in the file list window.
Deleting Files
To delete any of the duplicate files, you first position the cursor
(highlighted line) on the line containing the file to you want deleted. Hold
down the Ctrl key and hit 'D'. Upper or lower case is accepted. You will
be asked to confirm the deletion by answering 'Y' to the question 'delete
file?'. Any answer other than 'Y' will abort the delete and continue with the
file list.
If the file to be deleted is a standard DOS file it will be deleted
immediately. (Remember that a compression library is a standard DOS file and
there may be duplicates on your disk. If you delete it you will also delete
the files contained within it.)
If the file is contained within one of the compression protocol library files
the appropriate program ('PKPAK', 'PKZIP', LHARC, etc.) will be called to
perform the actual deletion. No checks are made to insure the deletion took
place as requested.
If you delete the compressed library file the contents of that library will
remain on the duplicate list. Any attempt to delete those files will probably
result in an error. (No checks are currently made to insure the file is still
present.)
The current version performs all requested deletions as the request is made.
Future versions will provide an option to store all external calls to the
compression/decompression programs until you request an exit to DOS. The
future plans also call for you to be able to 'install' the compression
library program of your choice.
Environmental changes
CUDUP allows you to change the environment under which you operate. You enter
the environment menu by using the /I command line option or by hitting the
F10 key when in the file list. At the present time you may do any of the
following:
Default colors
o Sets the default colors for the video card you are presently using.
If a monochrome or B&W video card is detected the system will set
for monochrome, otherwise the default colorset will be implemented.
Colors & Monochrome (B&W)
o Reset the colors or monochrome (B&W) for each of the display
windows.
- Each of the parts of the display windows is contained in the
two column list on the right of the screen. Use the up/down
arrows to select the window part you wish to change and hit
<Enter>. Then use the up/down/left/right arrow keys to
navigate within the color selection window until the selection
box is positioned over the new color for the selected part.
Hit <Enter> and the color will be stored.
NOTE: if you entered the color menu via the F10 key then most new
colors will only be made available for the following sessions.
- If you selected Monochrome from the menu or by the use of the
'/M' option on the command line, then the default colors will
be set automatically. NOTE: if you entered the menus via the
F10 key then the monochrome settings will take effect during
the next and following sessions.
Environmental changes (continued)
Files
o Select which of the compression protocols you wish to make active
for the current and/or subsequent sessions. The following list of
programs are, at the present time, the only ones the program
expects to support. This could change if additional protocols
surface. CUDUP will support as many protocol upgrades as is
possible.
ARC version 6.0
DWC version unknown (not implemented)
PAK currently version 1.6 ( plan to cover version 2.x)
LARC currently implemented using LHARC
LBR version unknown (not implemented)
LZH version 1.13 (expect new version any time)
MD version unknown (not implemented)
PKPAK no longer supported by PkWare. implemented in CUDUP
PKZIP version 1.01 (as of 8/23/89)
ZOO version unknown (the implementation is not tested)
When you 'turn on' an entry in the file table by hitting <Enter>
you must fill in 4 entry fields. These are:
Description: 12 characters describing the protocol exp.
ZIP ver 1.01
File: 12 character file name (not including path) of
the compression program used to perform
internal file deletions. This file must be in
the current DOS path. exp. PKZIP.EXE
Ext: File extention to look for when using this
protocol. Do not include the period. exp.
ZIP
Delete option: up to 6 characters. This is the command line
option used when performing the delete function
using the compression protocol. exp. -d
When you 'turn off' an entry in the file table by hitting <Enter>
the current fields will remain in effect but will be 'turned off'
for at least this session.
Environmental changes (continued)
Save and Exit
o Selecting this option will allow you to save any of your changes
to the configuration file. (CUDUP.CFG) The configuration file is
written as a text file but has no identification associated with
the fields. Any attempt to alter the .CFG file with a text editor
may destroy any changes you have saved. You may restore all of the
system defaults by deleting the configuration file. You may also
may the monochrome (B&W) option permanent by executing the program
as follows:
CUDUP /M /I<Enter>
- select the Save and Exit option from the menu. The
monochrome defaults will be written to the configuration
file and will take effect automatically from that point
on.
If you hit the Esc key you will exit the environmental menu but
your changes will only be effective during the current session.
You may re-enter the menus by hitting the F10 key if you wish to
save the environment to the configuration file.
NOTE: A future version of CUDUP will have an option to update
the executable instead of maintaining a configuration file. Future Revisions
CUDUP is by no means complete. I would like to propose that any changes made
to enhance this product be sent to me, Fred Hill, by regular mail, on disk
(5.25 or 3.5), or by message on Compuserve (PPN # 76060,102). If you send
code you may send it to me as a binary EMail msg. You will receive full
credit and will share in any future profits derived from the sale of CUDUP.
The actual profit sharing will be worked out to our mutual satisfaction prior
to inclusion of your code segments.
I have no plans to restrict access to the source code by registered users,
so if this will constitute a problem for you I ask that you not provide me
with your source code.
I also reserve the rights to make any and all changes at any time as I see
fit. All decisions concerning releases and changes will be made by me. I
expect this product to evolve very quickly into a full blown system utility
and updates will be placed in Shareware distribution channels as quickly as
they become available and tested.
This offer is available to registered users only.
Thank you for trying CUDUP - Please register